home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 May: Tool Chest / Developer CD Series May 1996 (Tool Chest) (Apple Computer) (1996).iso / Tool Chest / Development Tools & Languages / • Other Platforms / PCCTS 1.31 / README < prev    next >
Encoding:
Text File  |  1995-03-10  |  6.9 KB  |  200 lines  |  [TEXT/MPS ]
  1.  
  2.                             Welcome to PCCTS 1.31
  3.  
  4.                               January 1, 1995
  5.  
  6.        ***[RERELEASE January 5, 1995 to add PCCTSAST.C to distribution]***
  7.  
  8.                           Parr Research Corporation
  9.                                     with
  10.                   Purdue University Electrical Engineering
  11.                                     and
  12.                        University of Minnesota, AHPCRC
  13.  
  14.                                 Terence Parr
  15.                                 Russell Quong
  16.                                  Will Cohen
  17.                                  Hank Dietz
  18.  
  19.  
  20.                                 INSTALLATION
  21.  
  22.      This document describes the installation of PCCTS 1.31 on UNIX
  23. and non-UNIX machines.  The UNIX installation is trivial while the
  24. non-UNIX folks have a bit more work to do as an install script
  25. explicitly for there machine will not exist--they will have to
  26. interpret the install script.
  27.  
  28.      PCCTS 1.31 includes a number of different programs and examples
  29. in the software release package -- most of which like to live in their
  30. own directories.  The install script will build a standard hierarchy.
  31. Or, if you get the tar file off the ftp site, the hierarchy will be
  32. constructed automatically by tar.
  33.  
  34.      The PCCTS executables (antlr, dlg) may be placed anywhere the user
  35. wishes but the install script places them in the bin directory created
  36. during installation.
  37.  
  38. 1.0.  UNIX USERS
  39.  
  40. This section is for UNIX users and describes the most convenient
  41. installation procedure.
  42.  
  43. 1.1.  FORMAT: pccts.tar
  44.  
  45. To begin installation, place the pccts.tar file into the directory
  46. where you want to place a pccts subdirectory.  Untar the file with
  47.  
  48.      tar xvf pccts.tar
  49.  
  50. and cd into it.  To install PCCTS, simply type
  51.  
  52.      make
  53.  
  54. which will build the standard PCCTS directory hierarchy (under the
  55. directory where you ran the install script) and build executable
  56. versions of antlr and dlg.
  57.  
  58. 1.2.  FORMAT: pccts.bag
  59.  
  60.      To begin installation, the user should create a directory (usually
  61. called pccts) where the PCCTS source subtree is to be created.  Place
  62. the pccts.bag file and the install script into this directory and cd
  63. into it.  To install PCCTS, simply type
  64.  
  65.      sh install
  66.  
  67. which will build the standard PCCTS directory hierarchy (under the
  68. directory where you ran the install script), "unbag" all of the files
  69. and build executable versions of antlr and dlg.
  70.  
  71. If you do not have the 'sh' shell, you'll need the install.unbag.reqd
  72. file.
  73.  
  74. 2.0.  NON-UNIX USERS
  75.  
  76.      ANTLR was written using portable (we hope), vanilla K&R-style C,
  77. ANSI C, and C++.  It has been successfully ported to a variety of
  78. environments.  We do not provide an installation script explicitly for
  79. non-Unix users.  You must interpret the install script and perform the
  80. analogous operations on your machine.  There is an install script,
  81. install.mpw, for Macintosh programmers.
  82.  
  83. IMPORTANT NOTE:  For PC users:  You must create the parser.dlg and
  84.          "touch" scan.c in antlr and dlg directories or the
  85.          makefiles will try to execute antlr and dlg, which
  86.          don't exist yet.  The first time, you want only to
  87.          compile the C files in order to obtain an executable
  88.          for antlr and dlg.  From this point, a change in
  89.          antlr.g or dlg_p.g will force antlr/dlg to regenerate
  90.          themselves.
  91.  
  92.          You must define symbol PC if you want things to work
  93.          out right for use on a DOS, OS/2, Windows machine.
  94.          This affects the config.h file, which you can change
  95.          as you wish.
  96.  
  97.      For Mac programmers using MPW (Macintosh Programmer's Workshop),
  98. define symbol MPW to get the correct config.h stuff included.
  99.  
  100. 3.0.  EMAIL VERSION RECIPIENTS
  101.  
  102.      If you received PCCTS via email response from
  103. pccts@ecn.purdue.edu you have one additional installation step to
  104. perform over the ftp folks (and pccts.tar is unavailable).  You will
  105. have received a number of bite-size chunks of pccts which are small
  106. enough to be emailed (~1500 lines each).  You must reconstruct the
  107. PCCTS files before you can begin installation.  In order to rebuild an
  108. original file, you must have "one.c" which will take the chunks and
  109. pack them together.  If you are a non-UNIX type, you must have the
  110. "unbag.c" file which unbags the bags created by our mail archiver.
  111. UNIX folks use the shell to unbag as they would for shar files (this
  112. will be done automatically by the install script).
  113.  
  114.      To install PCCTS, place all PCCTS mail messages into a pccts
  115. directory, remove the mail headers from one.c.  Then compile one.c
  116. with:
  117.  
  118.      cc -o one one.c
  119.  
  120. and then type:
  121.  
  122.      ./one f1 f2 ... fn
  123.  
  124. where f1..fn are the parts of PCCTS source sent as chunks (i.e. these
  125. files will be all the files you received NOT including one.c, unbag.c,
  126. README, install and the request acknowledge banner).  There is no need
  127. to remove mail headers from the chunk files and they may appear in any
  128. order.  The subject line of the mail will identify it as a chunk and a
  129. chunk of what file.  The "one" program should be used to put pccts.bag
  130. back together.  You are now in a position to begin normal PCCTS
  131. installation.  All files you receive should go into a pccts directory.
  132.  
  133.      Note that all files which arrive in "chunks" must be put back
  134. together using "one".  Beware that you do not mix chunks from more
  135. than one original file.  For instance, do not specify all chunks that
  136. you collect from the PCCTS mailbot on the "one" command line unless
  137. you have requested only one original file that was split into multiple
  138. files.  Each chunk knows which original file it is a part of, where it
  139. goes in that file and how many total chunks are required to rebuild
  140. that original.
  141.  
  142. 4.0.  WORD SIZE AND PC USERS
  143.  
  144.      The config.h file now sets up the word size for your compiler
  145. automatically.
  146.  
  147.  
  148.                                 TUTORIAL
  149.  
  150.      The advanced tutorial should be placed in a directory at the
  151. same level as antlr, dlg, support etc...  Do a
  152.  
  153.      sh advtut.bag
  154.  
  155. to unbag (or use the unbag program) and then type
  156.  
  157.      make -s all
  158.  
  159. which will create executables called tut1-tut4.  Naturally, if you got
  160. the tutorials from the ftp site, the tar format of the tutorials can
  161. be obtained for easier installation.
  162.  
  163. Unfortunately, the tutorials have changed little since the 1.06
  164. release.  With luck, these will be enhanced and an AST tutorial will
  165. appear.
  166.  
  167.                          MACHINE COMPATIBILITY
  168.  
  169. PCCTS is known to compile "out of the box" on the following machines
  170. and/or operating systems:  [didn't have time to retest on all these
  171. machines, but seems to be highly portable still].
  172.  
  173. o  DECSTATION 5000
  174.  
  175. o  SGI, Running IRIX 4.0.5
  176.  
  177. o  Sun SparcStation (cc, gcc, g++, Cfront, acc)
  178.  
  179. o  VAX C under VMS
  180.  
  181. o  Linux SLS 0.99, gcc/g++
  182.  
  183. o  386 PC, NetBSD 0.9, gcc 2.4.5
  184.  
  185. o  HP 9000/755, HP-UX 9.01, HP cc
  186.  
  187. o  486 PC, OS/2 2.1 (w/long filenames), IBM C Set++ 2.1
  188.  
  189. o  NeXTStep 3.2 running g++/gcc 2.6.3 (pentium-90)
  190.  
  191.  
  192.                            INCOMPATIBILITIES
  193.  
  194. Please see the release notes.
  195.  
  196.  
  197.                                 CREDITS
  198.  
  199. Please see the history.ps or history.txt.
  200.